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1![>vr To Get 0-n To The S/stem 


3 ntroductlon 

This memo Is Intended to get very new users started on the MAC A3 
system. It presents somp simple rituals for meklng and editing 
f Hes, gett InE print out,making microtapes and so on. Most of the rituals 
given are not the only ways of doing something or even neccessarily the 
s imoleat,but they do work* 

Some sources of more detailed documentatIon are referenced at the end 
of this memo e read them when you want to know more* 

If you -don't understand something or need any kind of help jsjg . No one 
minds;they all know how you feel* 

Cautionary Mote 

This Is a research system Intended for maximum flexibility. There are 
few built In safeguards and It Is not idiot proof* It is up to vou not to 
screw other users. If In doubt or if you get an error message you don’t 
understand ask . 

Mlcrotanes are every users hack up storage* They are used to safeguard 
data and programs which must not be lost at any cost so be especially 
careful with af 3 tape routines* 


Getting a User ttame 


Go to MlnSliy's secretary and fill out all the appropriate forms* Your 
user name should; be known to the system In about a week, Ef Et taken much 
longer ask someone what to do* For the rest of this memo we’U pretend 
that your user name Ts USER. 

A Rote On Notat1 on 

Everything you type on a console will be shown below In capital letters 
and Indented e,g* 

FPO 

Everything the system types back will be also Tn caps and indented a 
bit more e,g* 

EAR 

Arbitrary Strings Inside commands are shown by lower case strings e.g. 
FPOarbitrarystrlng&AR 

Spaces by _ as- in 
FOO_BAR 

Carriage returns by 
or 

Control characters,produced by hitting the CTRL key and the appropriate 
character key simultaneously by e,g, 

Ct rl A 
ct r 1 K 


Alt jnodeigoc by hFttlng the ESC kEy,ls represented by a circled {lot tar 

sren: (?) 

Son 1 1 confuse this with the dollar sign key [shift L3 even though they 
both print the same when you hit the keys, 

Lo-EfilnE In end Out 

Find a free console which Is shoeing 
ETS E71 CONSOLE n FREE 

(Here and elsewhere the precise message given by the system may vary.) 
Now typer 
ctHZ 

The console wilt respond! 

DDT 27b 

followed by any message directed at the whole user cornnun \ t y. 

Now type your user name followed by @u 
USER ®U 

You are now logged In to DDT which Ts the top level program in the 
system. Typing: Ctrl I at any time will bring you back up to DDT 

and St Is from here that you log out by typing 

®® U 

The system will respond with 
ITS 671 CONSOLE n FREE 
and you can eo home* 

Always log out before you leave the console. 




Mat; fng a TECD FMe 


TECO is a character editor* ft lets you construct and edTt files and 
file them on disc or tape for later use> Type: 

TECD ct rIX the system will respond; 

TECO lODcr 

Now you are In TECQ, -All TECG commands are terminated by ■ This 

says. In effect,'Now do It, 1 Until you type the two alt inodes you can quit 
fcancel) any command string by typing 
ctrlG 

TECO filing and reading commands all start with an 1 E I * Try: 

£V ®© 

This will display your file directory which should have at least one 
file In It (otherwise the system wilt garbage collect you) Lets make 
another one. T I 1 Is the Insert command: 

I almostanystrlng ©(§) 

Inserts 1 almostanystr1ng* In the buffer. The string can Include any 
eortib Enat Ion of keyboard characters,spaces,carrEege returns etc except 
ct.rl. Z or alt mode. Try It. &y the way. If you hit a wrong key while typing 
in a string,you can erase the n preceding characters by hitting the 
'RU30 uT t key n times. The characters you've rubbed out will be echoed at 
the top left of your console. 

You haven't made a file yet - you still have to get the contents of the 
buffer into the output buffer,give It a name and file It. Do: 

n/ (!)($) 




Now look at your file directory again (EV ($)/S} )« You've created a 
temporary file -caned TECO OUTPUT. Se careful, though, it wit) disappear 
without trace if you give it a chance. Now choose a name for your file* 
Files must have two names,fNenamel and fi1ename2,separated by a space* 
For reasons which will become clear,fI 1cname2 Is almost invariably a 
number. We Ml name this one TRYDUT_1* Type; 

EETJIY0UT_1 @§) 

and look at your file directory again. There it is. 

The complete ritual,so far,goes: 

£inz 

USER (p U 

TECO otrU 

ieontentsofthef 1 le ($/$) 

EW ®® 

EEf ilenamel_l(|)(|) 

Editing a TECO Tile 

Before you can edit a file you must read it back into the buffer. Type 

ERTRYOUT^l ©Y gjg) 

Incidently the T Y‘ after the first alt mode controls where the file is 
read to and how. A. 1 Y T clears the buffer before 'yanking' the new fl!e 
Into lt;an 'A r In this position would append the file to the bottom of 
anything already tn the buffer;an 1 £' would make a listing of the file 
on the Line Printer. 




All; editing is done with respect to a pointer which can be moved around 
the contents of Che buffer and which can be seen on the display as /\ . 
Pointer moving compands are as follows: 


COMMAND 

EFFECT OH POINTER 

J®® 

zj SXD 

±nL ®® 

go to the tOP of buffer contents 

go to the bottom of buffer contents 

move +n 11nes,pointer left at beginning of the 


line* Note that n can be 0,and that n*i Is assumed in default. 


nC g® 

move n characters forward 

"R ©© 

9strlng (p® 

move n characters reverse 

search forwards for *strlng 1 pointer goes to rtght 

hand end of string* 


-Sstr Eng 

search backwards for f string 1 poEnter to left end 


Now you know how to move the pointer around you can edit the contents 
of the file* Editing commands are: 


HKg)® 

delete ±n characters from the pointer 

kill [delete) ±n lines from the pointer 

kill entire buffer contents 

and of course 


1 string @(t J 

Ensert 'str]ng T after the poEnter. 


Note that K (fXD WH delete the rest of the line after the pointer 
Including the carriage return* £99K(i;|D is useful for deleting, 
everyth ins above or below some point E n the buffer. 


Greater and Greater 


Nq>* you. want to file the edited! version of TRYOUT 1, If you ref lie If 
under Che sane name and sere** anything up you will lose the original as 
well. So file It as TRYOUT 2 . Wal£,though,you don’t have to keep track of 
*jhfch number you've got up to* Use ’>' as fll enamel and TECG will create 
filename! one greater than the previous number. You can use this for 
reading as well e*g* 

EU @@ 

eetryolit_> ©.(§) 

ERTftYDUT_> (|) Y 


(Do some more editing} 

EETRY0UT_> g)g) 

If you look at your file directory after all this you'll find you’re up 
to TRYOUT 3 and still have TRYOUT 1 and 2, 

When you've finished for the day and are about to log out^delete all 
the junk {previous versions of files) with EO. 

EDf 11 ercamel_f I 1 enamei deletes a file. 

You can use to remove the 1 east numbered filet 

EDfi1enanel_< ffl®- 



Page After Page After Pa£6 


So far, the files have been stngle pages. To make a multi-page file: 
rteKtofpajielgjtJ) Insert text of first page 

ELl^d) make somewhere for T t to go or you'll lose 


11 


P@© 

ftextofpage2 (|)(|) 

Pg>® 

(etc etc) 

EEftt enamel_>(|)© 


put ft out there 

insert text of second page 


name and ffle all the pages* 


TO' read and edit a mu 1 1 E-page files 

ERf i lenpmel_> £5) ¥ (s)© yank the first page Into the buffer 

*»<M) tf you are going to re*ffle an edited 

vers Ion 

(edit page 1) 

P ©© 0ut out the first page and get the next 

one Into the buffer 
(edit page 2) 

p ®§> 

(etc etc) 

EEf M enamel_> ©J© file the edited version* 


If you had Just wanted to read the file,not adit or rc-flle It,, you 
could have missed out the El . 1 and done Y 's instead of the P£lj(_$) ' s ta 

K et -each new page Into the buf fer, los Fng the previous buffer contents 
down the drain where all unwanted dupl Ecates of data go. 

To turn a single page Into several Ensert c-Lf.U . wherever you want a 
page boundary before re*fTHng It, 

To condense a multi-page file Into one page &et the new pages after the 
first Into the buffer with AA{j)@ Instead of P or V, 

To stitch two files together into onet 

£flfnel_> © Y g)g) read the first ffle 

EH ©@ 

93P®© get alI the pages out 

ERf Ile2_> (s) A©® 'A' for append 

EEtiewf I lename_> ©© 

Final 1 Yr 

ERf T tenamel^f E I enamel © Q ©(f) 

will put the whole file out on the line printer* {You can still use 1 > 1 
as filenames if it's appropriate. ) 


Evading, the Grim File Gobb 1 er 


Files stored on disk have been knonn to disappear in really bad system 
crashes so anything you really want to keep,put on Microtape. 
l>Get yourself a clean,marked,microtape. (Ask.) 

2HJrite your name on the reel* Every kind of Ink I’ve found so far 
rubs off so a sticky label may be the answer, 

3?Find a free tape drive, 

<4 J S w 11 c h the off/wrTtc-lock/write switch to 'off 1 , 

5Hoad the tape, (Get someone to show you how the first time*} 

63Switch to *wrlte'. 

7)Mote the number of the tape drive. Are you sure? 

How,back at your console,give the tape a name* (One day you may have 
several tapes} 

Do: 

nESnam 0 (j£) 

’n’ Is the tape drTve number. Are you su re ? 

'nam 1 Is any three character name for the tape* 

Mow you can write on the tape: 

QERf 1 lenamel_f 11 ename2 0 nE IYEE Q; (S) 

The first *Q’ Indicates the source device CC for disk) 

The 'n T Indicates the destination devicejput the tape drive number 
here. 

Filenames must be explicit. Do not use 1 >' ■ 



Now do EV to look at your tape file dl rectory ■ So far we've been 

taktos advantage of TECQ assuming you mean 'disk' unless told otherwise 
and then remembering what you last told ft. To took at your disk file 
directory aj^aln you must sayt 
EVDSK: @® 

And back to the tape directory? 

EVUTn: {£© 

where 'n 1 is the tape drTve number* 

Lastly, te fiap (remove) a tape,do: 

EK&® 

This should run the tape back onto lt r s reel and you can remove tt 
(switch to 'off 1 first). 

Check THAT IT HAS RUN RIGHT SACK* 

NEVER remove a tape that hasn't been flapped fully* 


If In doubt ASK FQH HELP 



Reading Other Users FTles 


Simple if you remember T£CO assumes that If you don"t tel) It something 
you mean the seme as last time* 

For Instance: 

EY©® 

Is an abbreviation for 
Ef DSK: username; 

In default TECO assumes the 'DSK' and remembers the lest user name It 
vi 35 told (when you logged Tn). So to look at FRED 1 ^ file directory do: 
EYDSK:FRED; 

Now anything you say will refer to FRED^ files unless you tell it 
otherwise e*g. by: 

ERTE1¥0UT„>_DSK: USER; Q) V ®@ 


Search Macros 

A useful feature when editing TECQ files 1 $ a facility that lets you 
search for every occurrence of a given string on a page in the buffer and 
do something (del ate#insert etc? when it is encountered* 

For instance to replace every occurrence of ‘A 1 by 'SEME 1 doi 

J (f)® t0 get to the toJJ c ^ e puffer V oul re not: already 

there,then: 

< g) ; 2 RD1S OME (?) > 

This says:search for each occurrence of spaceAspace In the buffer,move 


two characters left,dotete one character to the right and Insert SOME* 
1n General the form Is: 

<S5tr leg (§/ joperat tons I st rTng($] > (%}($) 



that matter!. 

(l Registers 

Useful for Juggling blocks of text or holding strings that you're going 
to Insert all over the place. 


HK 


clear the buffer < 3 f you need to) 

Istrl ng{^p($} 

KXq §)$) 

where ’q 1 Is the name of the Q rcgister^one character from A to Z or a 
number from 0 to 9< 

The string remains in the selected Q register until you log out or 
until you change It. for untTl you kill the job - see below! 


Qq@® 


inserts the Q regEster contents wherever you (the pointer! are 



will Insert n copies of the Q register contents In the buffer. 


How To Do n Things At CJnee 


We'll use some useful things as examples. 

You're In TECO and have just written a PLANNER pragram.To help debug It 
you want to 'PrettyPr3nc' It* Do; 
ct rl Z 

to get Into DOT, Wow do: 

NLISP ctrI K 
The system responds 
ALLOC 7 

to find out how much storage you want.Type 
N 

for 'normal' Now read the program which will do the work - 'GRIND' ♦ 

(UR E AD_G R f ND_>_COtt > 

System responds; 

(COM USER) 

Load the program by typing ct ri O and when U is loaded type; 

{EVAL(GRlH0l_f1Venamel_>_DS K )) 

The program w|Tl teli you when It's finished by; 

(DSK USER) 

to say that ft has filed the new version back In T£CO. Now you can look 
et It or print it out,Do ; 

Ctrl I 

to get back Into DDT, YOU DON'T HAVE To RELOAD TECQ, Do: 


The system responds 
TECO © J 
Now doi 

©P 

and you are back in TECG* You still have the LISP - you ten See this by 
doing a PEEK* ct r1 1 again and typo: 

PEEK etrl K 

You f ll see that under your user name are the names of the three jobs 
that you have going,T£CO, LISP and PEEK* PEEK Is the only one using any 
tTme* You can got back to any one of the others exactly -where you left 
off by going back to DDT,and doing© J’s until you get to the one you 
■want (This is called ’going round the job ring') and then doing ^ P to 
get down Tn-to Et* This is particularly useful if you are running,say, e 
PLANNER program fUhich takes a long time to reload! but want to use TECO 
for a short period or to PEEK to find out what all those other users are 
doing to make the system so slow* By the way,It's antTsocEai to keep jobs 
Open that you don't intend to use for a long time,sine# It takes up 
valuable core*You can kill a Job from DDT by moving round the job ring 
till you get to it and doing: 

:K 1 LLcr 

which kills the job and moves you round the job ring to the next one* 

You can kill PEEK by doing : 

Q 

at any time while you're running it :thEs takes you up to DDT and ktlls 
Ft in one fell swoop* 



It 1 11 Keep Till Tomorrow 


Normal 1 y, when you Ior out, you lose the current state of the program you 
were working wEth, If it Es ,say , a LISP that you've put a lot of work 
Into you'll be reluctant to leave It even |f ft means missing dinner 
and/or annoying your wife* So here is a way to save the complete state of 
e program on disk so you can got It back tomorrow 

I) Invent a file name for It* 

2} Dump It on your disk w11ht 

(jyY fElenamel^fElename2 cr 

Now It Is a TECO 1 disk file so you can log out safely* To £et It back 
again tomorrow: 

1J From DDT,name the job 
j obname J 

You might use YLl-SP [for 'yesterdays lisp 1 } as the job name for 
example* note chat you don 1 ! have to load a new LISP es the complete 
state of your previous LISP Is on disk, 

21 Load the file with 

@L f t lenamel^f T lename2 cr 

J) Start at starting location with 

® g 

Now you are back exactly where you left off yesterday* Don't forget t* 
ED the file from TECQ when you don't need It any more - It's taking up 
lots of room. 


Send, tommunl cate and ria El 


SemetIroes,whI le you are In the middle of working away at a console, a 
(usual 1y rude) me s s a g e will mysteriously appear Fn front of you * Wou1d n 1 1 
you like to send people rude messages? Well,this is how. 

To get Into 'conmunl cate' mode; type: 
et rl haekarrow C address^ 

where ’address' Is either a user name qr teletype number (backarrow Is 
shift 0 ;yes,thats right,you were pressing three keys at once then)* The 
system will respond wTth a ’g' for go or'B.' for busy. If It was G,your 
console Is now tied to the other users console until one of you types: 
Ctrl backarraw N 

When you start to communicate with someone your message Is prefixed byt 
MESSAGE FROM USER 

just to let them know that they are now In communicate mode too. 

'SENE 1 ’ will send a message one way without tying the consoles together. 
Do; 

; SEND_username_mes5Pge ct;r 1 C 

The message will be prefixed on their console by; 

MESSAGE FROM USER KACTRN 

Of course the people you send messages to must be currently logged In, 
You can check quickly by doing: 

TTYfilUJ 

from DDT. This doesn't take you out of DDT by the way. Ef you want to 
send a message to Someone who's not logged In you can use MA1 L Do: 




sUAI OJsernMifljiessajse Ctrl c 


and they *113 get the message the next time they Iqe In. 



Further Documentation 


Some sources of further documentation are listed belo*>* 

From DDT type: 

I HFO et r 1 K. 
and then: 

TECO(j) l 

to get an up to date listing of TECQ commands.Much useful Information Is 
reputed to live tn fMFO En any case. 

The following A*f. Memos should be available in the ninth floor 
document room: 

A*t. Memo fil PDP-6 TECO 

A,E, Memo 14 7 A Mult Epic Procedure DDT 

A,E* Memo 1E1A ITS 1.5 Reference Manual (ThEs contaEns details of 

PEEK amongst other things) 

Some people have copies of an anonymous draft Internal note called 
r Us1ng the MAC PPP“6 Time-Sharing system' get a Xerox copy if you can* 

This Memo will be suppi emented, as and nhen^Eth memos bearing the same 
number and an alphabetic suffix. 

The most useful source of documentation Is your ovin notes on iwhat other 
users tel I you» 

Finally, this Memo vies produced using TJ6 + See A.J* Memo 1G4A for 


details 


